第6章: 使用Log調試你的App

如何在B4A中使用Log

在應用程式開發過程中，調試是不可或缺的一部分。調試不僅可以幫助你識別和解決程式中的錯誤，還能讓你更好地理解程式的運行狀況。B4A 提供了強大的日誌工具 Log，可以幫助開發者在不同階段記錄重要訊息，以便於分析和排查問題。
使用Log的基本方法
在 B4A 中，使用 Log 是非常簡單且直觀的。你可以在程式的任意位置插入 Log 語句來輸出訊息。例如：

Sub Activity_Create(FirstTime As Boolean)
    Log("Activity 創建中...")
    Activity.LoadLayout("MainLayout")
    Log("介面已加載完成")
End Sub

上述範例中，Log("Activity 創建中...") 這行代碼會在 Activity_Create 方法執行時輸出一條訊息到 B4A 的日誌窗口中。這些訊息可以幫助你了解程式的執行流程，例如確認某個步驟是否成功完成或追蹤某個變數的值。
Log的進階用法
除了輸出一般的文字訊息，你還可以使用 Log 來記錄變數的值、監控條件分支的執行情況，甚至是捕捉例外錯誤。以下是一些進階的用法：
1. 記錄變數值：
◦ 在程式中經常需要檢查某個變數的當前值。這時候可以使用 Log 來打印該變數的值。

       Dim counter As Int = 10
       Log("Counter 的值是: " & counter)
       ```
    2. 監控條件分支：
        ◦ 當程式包含多個條件分支時，使用 Log 來確認每個條件是否被正確執行。

   If counter > 5 Then
       Log("Counter 大於 5")
   Else
       Log("Counter 小於或等於 5")
   End If
   ```
3. 捕捉例外錯誤：
    ◦ 當程式中可能會發生例外錯誤時，你可以使用 Try...Catch 結構來捕捉這些錯誤，並使用 Log 來記錄錯誤訊息。

       Try
           Dim result As Int = 10 / 0
       Catch
           Log("發生錯誤: " & LastException.Message)
       End Try
       ```
## 常見的調試技巧
在 B4A 中，有效的調試可以顯著提高開發效率。除了使用 Log 外，還有一些常見的調試技巧可以幫助你更快地找到並修正錯誤。
1. 適當使用斷點
B4A 支援在代碼中設置斷點來暫停程式的執行，讓你可以在特定行停下來檢查當前的變數狀態或代碼邏輯。這可以幫助你更精確地定位問題所在。
2. 善用逐步執行
在調試模式下，你可以逐行執行代碼，這有助於理解每一行代碼的影響，特別是在邏輯複雜的部分，如迴圈或遞迴調用中。
3. 檢查異常情況
在調試過程中，常常會遇到無法預期的錯誤或異常情況。例如除以零、陣列越界、空指針等問題。你可以使用 Try...Catch 結構來捕捉並處理這些異常，然後通過 Log 來記錄異常發生的原因。
4. 使用日誌過濾器
當應用程式較為複雜時，日誌窗口中的訊息可能會變得非常多。此時，可以使用 B4A 的日誌過濾器來過濾出你感興趣的訊息。例如，你可以只顯示包含特定關鍵字的日誌，這樣更容易找到問題的根源。
解決常見的錯誤
在開發過程中，無論是初學者還是有經驗的開發者，都不可避免地會遇到一些常見的錯誤。了解如何識別並解決這些錯誤，能夠顯著提高你的開發效率。
1. NullPointerException
問題描述：
    • NullPointerException 是最常見的運行時錯誤之一，通常發生在你試圖訪問一個尚未初始化的物件或變數時。
解決方法：
    • 在使用變數之前，確保它已經被正確初始化。例如：

  Dim myText As String
  myText = "Hello, world!"
  Log(myText.Length)  ' 避免在初始化之前使用 myText
  ```

2. ArrayIndexOutOfBoundsException
   問題描述：
   • 當你試圖訪問一個陣列中不存在的索引時，會引發此錯誤。例如，試圖訪問一個只有五個元素的陣列中的第六個元素。
   解決方法：
   • 在訪問陣列元素時，始終檢查索引是否在有效範圍內。例如：

      Dim numbers(5) As Int
      For i = 0 To numbers.Length - 1
          Log(numbers(i))
      Next
      ```
3. Division by Zero
問題描述：
    • 除數為零的情況會導致程式崩潰，這是數學上的未定義操作。
解決方法：
    • 在進行除法運算之前，檢查除數是否為零：

  Dim dividend As Int = 10
  Dim divisor As Int = 0
  If divisor <> 0 Then
      Dim result As Int = dividend / divisor
  Else
      Log("錯誤：除數不能為零")
  End If
  ```

4. Syntax Error
   問題描述：
   • 語法錯誤通常在編譯時期就會被檢測出來，常見的語法錯誤包括漏寫括號、錯誤的變數名、缺少冒號等。
   解決方法：
   • 仔細閱讀錯誤訊息，找到語法錯誤所在的行並進行修正。通常，B4A 會提供具體的錯誤位置和描述，這對於修正語法錯誤非常有幫助。

範例程式：綜合應用Log進行調試

下面是一個範例程式，它模擬了一個簡單的應用程式操作，並使用 Log 來記錄調試訊息，以便在開發過程中檢查程式的正確性。

Sub Process_Globals
    ' 全域變數
End Sub

Sub Globals
    ' 活動(Activity)變數
    Dim count As Int
End Sub

Sub Activity_Create(FirstTime As Boolean)
    Activity.LoadLayout("MainLayout")
    count = 0
    Log("Activity 已創建")
End Sub

Sub Activity_Resume
    Log("Activity 恢復")
    Log("目前計數器值: " & count)
End Sub

Sub btnIncrease_Click
    count = count + 1
    Log("按下增加按鈕, 計數器值為: " & count)
End Sub

Sub btnDecrease_Click
    If count > 0 Then
        count = count - 1
        Log("按下減少按鈕, 計數器值為: " & count)
    Else
        Log("計數器值不能低於0")
    End If
End Sub

Sub Activity_Pause (UserClosed As Boolean)
    Log("Activity 暫停")
End Sub

Sub Activity_Destroy
    Log("Activity 銷毀")
End Sub

這個範例程式展示了如何使用 Log 來追蹤應用程式的狀態變化和變數值變化，並在程式的各個階段記錄訊息，幫助你更好地理解應用程式的運行流程並及時發現問題。
總結來說，Log 是 B4A 中一個強大而簡單的調試工具。通過靈活運用 Log 和其他調試技巧，你可以更有效地排查問題，提升應用程式的穩定性和用戶體驗。
參考網址
https://www.b4x.com/b4a.html
https://github.com/AnywhereSoftware/B4A